home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 12 / CU Amiga Magazine's Super CD-ROM 12 (1997)(EMAP Images)(GB)[!][issue 1997-07].iso / CUCD / CDROM / QuickSampler / QUICKSAMPLER_E.doc < prev    next >
Text File  |  1997-03-27  |  13KB  |  341 lines
  1.  
  2.                              QUICKSAMPLER  ©
  3.                             -----------------
  4.  
  5.               A program for reading digital audio data (CDDA) out
  6.                              of CD-ROM drives. 
  7.                    QUICKSAMPLER V1.00  © 1996/1997 by Mario Kubek
  8.                            ALL RIGHTS RESERVED!
  9.                         Version 1.00 March 26 1997
  10.                     Date of the last change: March 28 1997.
  11.                             Author: Mario Kubek
  12.                          This program is Freeware!
  13.  
  14. 1. The program
  15.  
  16.  1.1    Introduction        -  What is QUICKSAMPLER?
  17.  1.2    Requirements        -  Was is required to run the program?
  18.  1.3    Features            -  What special abilities does it have?
  19.  1.4    Installation        -  Where to put it to?
  20.  1.5    Functions           -  Descriptions of the GUI and the TOOLTYPES
  21.  1.6    Compatibility       -  Which drives have been tested?
  22.  1.7    Errormessages       -  Hope you will not see any of them!
  23.  1.8    Bugs                -  Yes, yes the bugs!
  24.  
  25. 2. History und future
  26.  
  27. 2.1    History of QUICKSAMPLER  - What is new in this version?
  28. 2.2    TO DO                    - What can be expected in the future?
  29.  
  30.  
  31. 3. Important additional information
  32.  
  33. 3.1    Author,Updates,Sourcecode,Registration - Get in contact!
  34. 3.2    COPYRIGHT NOTE and DISCLAIMER          - Please, read it!
  35.  
  36.  
  37. 4. THANKS
  38.  
  39.        THANKS  -  Thanks go to ...
  40.  
  41.  
  42.  
  43. 1.1 Introduction
  44.  
  45. QUICKSAMPLER is a program for reading digital audio data (CDDA) out
  46. of CD-ROM drives, which are capable of sending digital audio data 
  47. (16 Bit) over the SCSI bus.
  48. This data can be saved in a file to a disk.                  
  49. This version works with TOSHIBA drives.
  50.  
  51. 1.2 Requirements
  52.  
  53. You need to run the program an AMIGA (that's clear) with at least a
  54. 68020 processor and a SCSI-Controller with CD-ROM drive, which is able of 
  55. sending digital audio data (16bit) over the SCSI bus.
  56. Most drives do not support this feature. Take a look at the compatibility
  57. list to get to know, if your drive has this ability.                               
  58. I recommend the use of TOSHIBA drives. I own the TOSHIBA XM-5301B and
  59. it works great.
  60.  
  61. Kickstart 3.0 is required, but it should also work with Kickstart 2.xx
  62. (not tested).
  63.  
  64. 1.3 Features 
  65.  
  66. QUICKSAMPLER V1.0 can/does...
  67.  
  68. ...save CDDA data (whole songs or part of songs) to a file in a very
  69.    FAST way.
  70. ...save the audio data in the fileformats: CDR, RAW, 8SVX 
  71. ...convert the CDDA data to following samplerates: 44100 (44.1 kHz),
  72.    22050 (22.05 kHz), 14700 (14.70 kHz), 11025 (11.025 kHz)       
  73. ...change the byte order (MSB [Motorola format] at first or LSB [Intel 
  74.    fromat] at first) when saving 16bit data.  
  75. ...change the audio channels in the file: STEREO, CHANGE STEREO
  76.    CHANNELSIDE (what you normally hear on the left speaker of the CD
  77.    is the right channel in the file and what you hear on the right
  78.    speaker is the left channel in the file), LEFT ON BOTH CHANNELS
  79.    (what you can hear on the left channel on a CD is what you get 
  80.    on both channels in the file, the right one has no influence), RIGHT 
  81.    ON BOTH CHANNELS (what you hear on the right channel on a CD is what 
  82.    you get on both channels in the file, the left one has no influence),
  83.    MONO (the left and the right channel are summed up and devided by 2),
  84.    MONO_LEFT (you will get only the left channel in the output file),
  85.    MONO_RIGHT (you will get only the right channel in the output file).
  86. ...offer you a good looking process bar.
  87. ...tell you using the GUI how many bytes will have the output file.
  88. ...check before writing to disk, if there is still enough place.  
  89.    Imagine you want to create a file, which is bigger than the available
  90.    free space on the disk. Then QUICKSAMPLER creates the audio file, sets 
  91.    it's size, which is calculated with intern routines. During this 
  92.    process it can happen that the end of the disk is reached. In this
  93.    case QUICKSAMPLER closes and deletes the file, because it does not
  94.    make sense to write to a file, which wouldn't contain all the data
  95.    you wanted to have in it. Some other programs do not check the free 
  96.    diskspace. They simply write the audio data to the file after they
  97.    have created it. So it could happen that during the writing process
  98.    (lets say 1 or 2 minutes later) the end of the disk is reached. 
  99.    What now? The user loses time and audio data, which should be in the 
  100.    file. 
  101. ...not waste ram-memory. The allocated memory is determined using
  102.    the WB-tooltype "BUFBLOCKS" or with the CLI-Argument "BUBLOCKS".
  103.    BUFBLOCKS can be a number between 0 and 65. The smaller the number
  104.    is, the smaller is the allocated memory and QUICKSAMPLER must read
  105.    from the CD more often. The bigger the number is, the bigger is
  106.    the allocated memory and QUICKSAMPLER must read from the CD less
  107.    often. Default number is 32. There are 3 buffers that have to be
  108.    allocated. The sizes of them are calculated with the formula 
  109.    (BUBLOCKS*2352/a_number_between_1_and_17) or 
  110.    (BUBLOCKS*2352*2) when data in RAW 16bit STEREO 44.1 kHz are changed 
  111.    (CHANNEL processing) and saved.    
  112. ...offer you a fast reading and writing routine (also for STEREO 8SVX).
  113.    It is not so compulsory to write such a routine as you might think of.
  114.     
  115.  
  116. ATTENTION: The best quality 44.1 kHz is waste of diskspace, because 
  117.            you normally hear tones (only) until approximately 20 kHz.
  118.            I suggest the samplingrate 22050. 
  119.            A file with 22.05 kHz is half so big as a file with 44.1 kHz.
  120.  
  121. 1.4 Installation 
  122. Simply drag the drawer of this program (it is the best if all additional
  123. files are in it e.g.: the documentations) where do you want to have it.
  124.  
  125.  
  126. 1.5 Functions
  127.  
  128. The program should be controlled by the following tooltypes:
  129.  
  130. DEVICE=<your_scsi_device>  Default is 1230scsi.device.
  131. UNIT=<your_unit_number>    Default is 2.
  132. BUBLOCKS=<a_number_between_0_and_65> Default is 32. 
  133.    The allocated memory is determined using
  134.    the WB-tooltype "BUFBLOCKS" or with the CLI-Argument "BUBLOCKS".
  135.    BUFBLOCKS can be a number between 0 and 65. The smaller the number
  136.    is, the smaller is the allocated memory and QUICKSAMPLER must read
  137.    from the CD more often. The bigger the number is, the bigger is
  138.    the allocated memory and QUICKSAMPLER must read from the CD less
  139.    often. Default number is 32. There are 3 buffers that have to be
  140.    allocated. The sizes of them are calculated with the formula 
  141.    (BUBLOCKS*2352/a_number_between_1_and_17) or 
  142.    (BUBLOCKS*2352*2) when data in RAW 16bit STEREO 44.1 kHz are changed 
  143.    (CHANNEL processing) and saved.    
  144.  
  145.   
  146. THE GUI:
  147. --------
  148. The all gadgets should be self-explaining.
  149.  
  150.             GADGET                FUNCTION     
  151. ----------------------------------------------------------------------
  152. Sliders: - "TRACK"                Chosing of the audio track on the 
  153.                                   CD, from which should be sampled.
  154.  
  155.          - "FROM"                 Gives the starting position for
  156.                                   sampling in minutes and seconds.
  157.              
  158.          - "TO"                   Gives the ending position for 
  159.                                   sampling in minutes and seconds.
  160.  
  161. String:  - ""                     There you can enter the name of
  162.                                   the output file. 
  163.                                   ALWAYS PRESS THE RETURN KEY after
  164.                                   you have entered the name of the 
  165.                                   file or you will not be able to
  166.                                   sample. ("DO IT!" Gadget is still
  167.                                   ghosted.)
  168.  
  169. BUTTONS: - "FILE"                 A requester will appear in which you 
  170.                                   can enter the name of your output file
  171.                                   with the path.
  172.  
  173.          - "DO IT!"               Press it and the sampling process 
  174.                                   should start. 
  175.                                   THIS BUTTON WILL ONLY BE ENLIGHTENED
  176.                                   IF YOU HAVE GIVEN A VALID OUTPUT FILE.
  177.                                   If your drive does not support the
  178.                                   of digital audio data, you will
  179.                                   receive an error message.                                   
  180.  
  181.          - "ABORT"                Stops the sampling process.
  182.  
  183.          - "ABOUT"                Shows information of the program and
  184.                                   the author.
  185.  
  186. CYCLES:  - "CHANNELS"             Take a look at the features-list
  187.                                   to get to know the functions.
  188.  
  189.          - "FORMAT"               Changes the output format: RAW, CDR
  190.                                   (data with no loss of quality), 
  191.                                   8SVX (IFF-Format 8 bit) 
  192.                                        
  193.          - "BITS"                 Changes the bit-resolution (8/16bit)
  194.                                   when saving in the RAW-format.                     
  195.  
  196.          - "FREQ"                 Changes the frequency: 44.1 kHz,
  197.                                   22.05 kHz, 14.7 kHz, 11.025 kHz.
  198.  
  199.          - "MSB/LSB"              Changes the byte order when saving
  200.                                   in RAW 16bit.
  201.  
  202.   
  203. @endnode
  204.  
  205.  
  206.  
  207. 1.6 Compatability
  208.  
  209. CD-ROM drive             works y/n
  210. -----------------------------------
  211. -TOSHIBA drives                y 
  212.  since 3401
  213.  
  214.          
  215.  
  216.  
  217. Others may work, but I haven't tested them! Try it with yours! 
  218.  
  219. 1.7 Errormessages
  220.  
  221. There are many and various errormessages in the program. They are
  222. easily to understand and must not be explained here. In most
  223. cases when an error occures during the reading process, the sampling
  224. is stopped (for instance: if your drive does not support the function
  225. of reading digital audio data or when it is not compatible with the
  226. TOSHIBA drives or the command of reading digital audio is not 
  227. compatible with your drive.
  228.  
  229. 1.8 Bugs
  230.  
  231. Currently none known.
  232.  
  233.  
  234. 2.1 History of QUICKSAMPLER
  235.  
  236. Version 1.00 (first release)
  237.  
  238.  
  239. 2.2 TO DO
  240.  
  241. - support for more CD-ROM drives 
  242.  
  243.   If you have any wishes or ideas for the development of QUICKSAMPLER
  244.   it would be nice if you could get in contact with me 
  245.   
  246.  
  247. 3.1 Author,Updates,Sourcecode,Registration
  248.  
  249. The program QUICKSAMPLER and this document are written by
  250.  
  251.                 Mario Kubek
  252.  
  253.  
  254. Mail to:                       Mario Kubek
  255.                                Lessingstr. 39
  256.                                D-07318 Saalfeld
  257.  
  258. Bugreports and ideas for improving this program are welcome.
  259.  
  260.  
  261. Where do I get the Updates?
  262.  
  263. Updates of QUICKSAMPLER you will find in the Aminet(Aminet/disk/cdrom).
  264.  
  265.  
  266. The proram is written in C. You can get the sourcecode if you send me
  267. a disk with your name.
  268.  
  269. If you find this program good, then you can send me a small fee 
  270. about 15DM or US$10 in an envelope. But this is a "can" not a "must",
  271. because the program is freeware.
  272.  
  273. At the same time you will get the newest version of QUICKSAMPLER, when
  274. you have put a disk into an envelope, and you become a registered 
  275. user. 
  276.  
  277.  
  278.  
  279. 3.2 COPYRIGHT NOTE and DISCLAIMER
  280.  
  281. The program-packet consists of:
  282. documents: "QUICKSAMPLER_E.guide", "QUICKSAMPLER_E.doc"
  283.            "QUICKSAMPLER_D.guide" and "QUICKSAMPLER_D.dok"
  284. program:   "QUICKSAMPLER"
  285.  
  286.  
  287.  
  288. QUICKSAMPLER is Copyright © 1996/1997 by Mario Kubek
  289. QUICKSAMPLER_E.guide is Copyright © 1996/1997 by Mario Kubek
  290. QUICKSAMPLER_E.doc is Copyright © 1996/1997 by Mario Kubek
  291. QUICKSAMPLER_D.guide is Copyright © 1996/1997 by Mario Kubek
  292. QUICKSAMPLER_D.dok is Copyright © 1996/1997 by Mario Kubek
  293.  
  294.  
  295. All rights resered.
  296.  
  297. QUICKSAMPLER is Freeware. The author has the copyright for the
  298. program "QUICKSAMPLER" and for all the documentations to the executable. 
  299. All rights reserved.
  300.  
  301. It may be distributed freely as long as
  302. no modifications are made to the executable and the documents. A small
  303. fee may be asked to cover distribution costs.
  304.  
  305. QUICKSAMPLER may not be used for any commercial purposes or included 
  306. with any commercial product without the written permission of the author.
  307.  
  308. The author can not guarantee, that the program will function on your
  309. computer. 
  310. The author takes NO responsibilities for damaged Amigas, CD-ROM drives
  311. or any other components or data involved while using QUICKSAMPLER or
  312. while using the documentations.
  313.  
  314. Your are using it at your own risk.
  315. There is no guarantee for further updates. There is also no
  316. guarantee, that bugs are removed in them. 
  317.  
  318. The program-packet is also free of rights of third persons.
  319.  
  320. NOTE: In almost all cases it is NOT legal to copy any CD.
  321.       That includes, that no digital audio data are read from a CD.
  322.       Though you own the CD you do not own the rights for the CD. 
  323.       Please do NOT violate existing rights. You are responsible for
  324.       it.
  325.  
  326.  
  327. 4  THANKS
  328.  
  329. Thanks must go to:
  330.  
  331. - Thomas Wenzel for his great program Play16!
  332.  
  333. - TOSHIBA for the best und fastest CD-ROM drives!!!
  334.  
  335. - MAXON for the great C++ Compiler MaxonC++ 4.0 Dev. Professional.
  336.   MaxonC++ is Copyright © 1996 by MAXON Computer GmbH.
  337.  
  338. - Phase 5 for the fastest turboboards and SCSI-Controllers for the 
  339.   AMIGA.
  340.  
  341.